Table of contents

Table of contents

The table of contents is normally inserted directly before the first headline of the file. The depth of the table is by default the same as the number of headline levels, but you can choose a smaller number, or turn off the table of contents entirely, by configuring the variable org-export-with-toc, or on a per-file basis with a line like

#+OPTIONS: toc:2          (only to two levels in TOC)
#+OPTIONS: toc:nil        (no default TOC at all)

If you would like to move the table of contents to a different location, you should turn off the default table using org-export-with-toc or #+OPTIONS and insert #+TOC: headlines N at the desired location(s).

#+OPTIONS: toc:nil        (no default TOC)
...
#+TOC: headlines 2        (insert TOC here, with two headline levels)

Multiple #+TOC: headline lines are allowed. The same TOC keyword can also generate a list of all tables (resp. all listings) with a caption in the buffer.

#+TOC: listings           (build a list of listings)
#+TOC: tables             (build a list of tables)

The headline’s title usually determines its corresponding entry in a table of contents. However, it is possible to specify an alternative title by setting ALT_TITLE property accordingly. It will then be used when building the table.